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Introducing LightShip™ 


Pilot™ LightShip is an object-oriented application 
development package for creating Executive Information 
Systems (EIS). LightShip allows you to build an EIS in less 
time than ever before, without writing any code. This section 
describes what an EIS is and looks at the components that 
make up a LightShip application. 


LightShip applications can display data from external sources 
such as dBASE® files, SQL servers, ASCII text files, and any 
Microsoft” Windows™ compatible application that conforms 
to standard rules of Windows Dynamic Data Exchange (DDE). 
DDE is a protocol that allows applications to exchange data on 
a real-time basis. 


What Is an EIS? 


An EIS brings managers and executives vital information about 
their businesses — right to the PCs on their desks, EIS 
applications are frequently used for performing database 
queries that display on-screen reports and charts. LightShip 
enables you to quickly create applications that provide: 


= Data display (including spreadsheet data, charts, text, and 
graphics). 

Open data access with active software links. 

Drill-down information navigation. 

Variance reporting. 

Trend analysis. 


Figure 1 shows the top level screen of the LightShip demon- 
strations. This screen displays icons you can click on to start 
the demonstrations. 
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Data Display 
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Figure 1 The Top Demonstration Screen 


LightShip screens allow you to combine text, numbers, charts, 
and graphics, as illustrated in Figure 2. 


Region by State 
Return! Demo Help! 


Massachusetts 
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Expenses: 
R&D 
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Admin. 
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1991 
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$0 $20000 $40000  $60000 


Figure 2 Data Display 
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Open Data LightShip is designed to work with other programs that 

Access provide data. You can display data from different sources on 
one screen, which updates as soon as the source data changes. 
Figure 3 shows an application that displays data from a dBASE 
file, using LightShip Lens™. 


=] Interactive Reporting 
Review Calculator! Demo Help! 


17171990 | | All Products 


Sales Units 
Actual Budget Varence Actual Budget 
$368,457 $351,635 $16.822 29.100 27.227 
$397. 132 $14,362 32.074- 32.371 
$397.680 $-18.606 30.958 31.077 
$430, 382 $9. 195 34,633 34,702 
$476,627 $-10,049 36.882 37,731 


| Units Variance 


Figure 3 Open Data Access 


Drill-Down Review Drill-down review allows end-users to navigate through the 
data; to display more information about an item, just click on 
it. For example, Figure 4 shows the screen that appears when 
you click on the Diet Drinks item shown in Figure 3. 
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=] Interactive Heporting EE 
Review Calculator! Demo Help! 


17171990 | Diet Drinks by Channel 


Sales Units 
Actual Budget č Actual’: Budget Venace 


Fountain $136.036 $126,367 10.877. 10.287 290 
Other $128.201  $127.353 10.211) 5 10.645 +434 
Retai] $148.257 $143.412 11.286: 11.439 -153 


Dollars ($) Variance 


= + ł i 
2000 490 6000 8000 10 


Figure 4 Drill-Down Review 


Variance reports display numbers that are greater or less than 
projections. With a LightShip application, management can 
define key performance indicators and windows of acceptable 
results. LightShip then highlights indicators that are under or 
over plan, as shown in Figure 5. 


LightShip to Excel Demonstration 
turn! Demo Help! 


Entertainment Income Statement 
Jul 1991 Actual Budget Variance 
To Budget 
Headcount 2 1.263 
GROSS SALES : -501 33 172.458 
Less: Returns/Al lowance 7.03 6.553 81. 7.206 
NET SALES > -948 165.252 
DIRECT COST OF SALES - -496 pay: 75.283 
Percent age 36 sos Go a 46 


GROSS PROFIT ° -451 89,969 
Percentage 64 54 


OPERATING EXPENSES 


AEN: : HI- 
& hobit SAREE 
eadcount Expense Headcount Net Sales Expense 
{Trend} (Cross) {Trend} (Cross) (Cross) 


Figure 5 Variance Reports 


Trend Analysis 
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You can easily chart any data displayed on the screen, allowing 
end-users to quickly see trends and relationships in their data. 
Data and charts are dynamically linked so that charts are 
automatically updated. 


LightShip to Excel Demonstration 


Return! Demo Help! 
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Figure 6 Trend Analysis 


About This Tutorial 


This tutorial shows you how to build a simple application. 
After installing LightShip, use it to get a quick overview of the 
application building process and see how the different 
components of LightShip work together. This tutorial has 
seven exercises, which show you how to: 


Create a screen background. 

Display data from text files. 

Display text and draw objects. 

Calculate variances. 

Display text files dynamically. 

Create charts. 

Go to another screen and pass parameters to it. 
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The Tutorial Files 


The Tutorial 
Screens 


This tutorial assumes you are familiar with Microsoft Windows. 
Before starting, look over Chapter 1 in the LightShip User’s 
Guide, which describes documentation conventions, how to 
start LightShip, how to use the control menu, and how to 
manipulate the LightShip window. 


The text and image files you need to build the tutorial 
application are in the \LS\TUTORIAL directory. These 
directories were created when you installed LightShip. The 
files are named as follows: 


CONSOL3.TXT 
CONSOL3A. TXT 
CHEM3.TXT 
CHEM3A.TXT 
ELECT3.TXT 
ELECT3A.TXT 
PAPER3.TXT 
PAPER3A.TXT 
. HEADER.PCX 
0. SCREEN1.LSF 
1. SCREEN2.LSF 


Seen ay ay NE 


Note that the LightShip 2.0 tutorial files are also in this 
directory. You can disregard these files. 


A LightShip application can include many screens, each of 
which may display reports, charts, and graphic images. You 
create and arrange objects on each screen to display data and 
to allow end-users to perform actions, such as displaying a 
chart, highlighting variances, or going to another screen. 
Figures 7 and 8 show the screens you will build in this 
tutorial. The names of the objects that make up the screen are 
displayed in the margin. 


To shorten the time it takes to finish the exercises, the tutorial 
provides one completed screen and one template for a screen 
you will build. The tutorial suggests the colors to use as you 
add each new object. These colors were developed by a 
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graphic artist and are intended as recommendations. You can, 
of course, choose any colors or fonts you wish. 


Figure 7 shows the screen you will build from the template. 
This screen displays actual and budget sales figures for a 
company. 


E “LightShip Tutorial Screen 1 
Eile Edit Special 


Image Object Global Industries, Inc. 
Text Object Reports 


Actual Budget 


Sales E 

Document Objects and Chemical $35.823 $50,000 Consolidated 
Electric $43.955 $33,000 Chemical 
Hotspots Paper $27.783 $20.000 Electric 


Total Sales $107.561 $103,000 


Charts 


-20000 -10000 10000 20000 


2 Actual Variance 


Budget 


Figure 7 The First Screen 


Figure 8 shows the second tutorial screen, which is provided 
as a completed screen. This chart graphs five years worth of 
sales and expense numbers for the report or division shown 
on the first screen. 
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Image Object 


Chart Object 


Image and Hotspot 
Object Buttons 
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LightShip Tutorial Screen 2 MA 
Eile Edit Special Return! 


Global Industries, Inc. 


1988 1989 1990 


EJ Sales 
EJ Expenses Consolidated Report Total Sales vs Total Expenses 


Figure 8 The Second Screen 


The buttons along the lower screen are created with draw 
objects that have text objects and invisible hotspots placed 
over them. Hotspots define the actions that the button carries 
out. Each hotspot on this screen changes the chart type when 
you Click on it. 


Exercise 1: Creating a Screen Background 


The application screen you will build in this exercise displays 
sales reports for different divisions of a company. 


Starting LightShip 


If you have a LightShip icon, you can start LightShip in 
Windows by double-clicking on the icon. Otherwise: 


1. Start the Windows File Manager. 
2. Select the LS drive and directory. 
3. Double-click on the file LS.EXE. 


LightShip opens with a new screen in the window, shown 
in Figure 1-1. 


Figure 1-1 The LightShip Window 


1-1 
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LightShip has three levels: Browse, Capture, and Author. You 
use the Browse and Capture levels for testing and running 
applications. You are at the Author level now, which you use 
for building applications. 


Opening the First Screen 


You will start building the first screen from an existing file. It 
contains several draw objects to use as frames for data you will 
display. We saved the draw objects as one Clipboard image to 
make the screen open faster. 


LJ) To open the first screen: 


1. Choose File Open. 


=| LightShip - Untitled Bae 
File 
F8 


Open... 
Save K F9 
Save As... Shift+F9 


Print 
Printer Setup... 


Figure 1-2 The File Menu 


The dialog box shown in Figure 1-3 appears. 


2. Select LS\TUTORIAL from the Directories list box. 


1-2 


Exercise 1: Creating a Screen Background 


The Directory item displays the current drive and 
directory. 


3. Select SCREEN1.LSF from the Files list box. 


File Open 
Filename: 


Directory:  e:\Is\tutorial 


Files: Directories: 
screen] .lsf 
screen2.lsf 


AI Search Path 


Figure 1-3 Selecting a File to Opening 


4. Click the Search Path check box to tell LightShip to use 
the file search path. 


When you open a screen, if Search Path is on, LightShip 
looks for the file in the current working directory first, 
and then in a search path you have defined, such as your 
DOS Path. If Search Path is off, LightShip searches only 
the directory specified on the dialog box. 


5. Choose OK. 
The file opens, as shown in Figure 1-4. 


6. (Optional) To enlarge the screen, click the Maximize box 
in the upper-right corner of the window. 
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Maximize Box 


LightShip - E\TUT3\SCREENI.LSF 
File Edit Options View Special Tool 


image Object 


Figure 1-4 The First Tutorial Screen 


Before You Begin 


LightShip objects are ordered in relation to each other; you 
can think of them as being stacked, similar to a deck of cards. 
By default, each new object you create is in front of the one 
you created previously. LightShip also has an option that 
allows you to create each new object behind all other objects. 


This tutorial assumes you are using the default method. 
Before you begin creating objects, check and make sure that 
Special Create in Back is not on, because this will affect the 
order in which objects are created during the building of the 
tutorial application. 


1. Choose the Special menu, as shown in Figure 1-5. 


1-4 
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LightShip - EA\LS\TUTORIAL\SCREEN | .LSF 
Eile Edit Qptions Yiew BEI Tool [mage 


Send Backward F7 
Bring Forward = Shift+F7 
Send to Back 

Bring to Front 

Create in Back, 


Variables... 

Calculate Now F11 
Calculation Shift+F11 > 
Debug 


Retrace Path... 


2. Make sure Create In Back does not have a check mark next 
to it. 


If it does, choose it to turn it off. 


Creating an Image Object 

In this section, you will import a PCX file that contains the 
header for the screen. PCX is a bitmap file format. First you 
need to create an image object in which to display the image. 


O To create an image object: 


1. Choose Tool Image. 
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LightShip - EALS\TUTORIAL\SCRNEENI.LSF 
Eile Edit Qptions View Special 


Y Select Esc 


Chart 
Document 
Draw 
Format 
Hotspot 


Toolbox 


Figure 1-6 The Tool Menu 


The cursor changes to a crosshair, indicating that you are in 
Create mode. Notice that the Image menu has appeared on 
the menu bar. Whenever you create or select an object, the 
menu for that object appears on the menu bar. This menu 
allows you to define attributes for the selected object. 


Figure 1-7 Creating an Image Object 


2. Hold down the left mouse button at the upper-left corner 
of the screen, as shown on the left in Figure 1-7. 


Exercise 1: Creating a Screen Background 


Then drag the mouse from left to right, down and across 
the screen (as shown on the right in Figure 1-7) and 
release the mouse. 


3. Choose Image Source PCX File. 


LightShip - EA\LS\TUTORIAL\SCREEN1.LSF 
nage 
Source 
ALEAT Sa Scaling... 


— h. v Fit Object to Image 
š ran Fit Image to Object 
DDE Data Request... 


Figure 1-8 The Image Source Menu 
The dialog box shown in Figure 1-9 appears. 


4. Select the file HEADER.PCX in the Files list box. 


1-7 
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Image Source File 
Filename: 


Directory: e:\Is\tutorial 


Files: Directories: 


Figure 1-9 Selecting the Image File 
5. Choose OK. 


The image appears on the screen. 


LightShip - EALS\IUTORIAL\SCREE NT. St 


) Global Industries, Inc. 


Figure 1-10 The Image Object 


1-8 


Four-headed Arrow 


rs Note that 


when an object is 
selected, it is 


enclosed ina 


rectangle. To select 


an object, click on 
it. To deselect it, 
click elsewhere on 


the screen. 


Exercise 1: Creating a Screen Background 


You might need to reposition it slightly. 
O To move the image object: 


Point to the object and hold down the left mouse button. 
When the cursor changes to a four-headed arrow, drag the 
object to its new position. When you release the mouse, 
the cursor changes back to the pointer. 


Figure 1-11 Moving the Image Object 


Coloring the Screen 
O Now select a background color for your screen: 
1. Choose Options Screen Color. 


The dialog box shown in Figure 1-12 appears. 
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Screen Color 


Invisibl 


Figure 1-12 Coloring the Screen 
2. Select the black square in the top-left corner. 


3. Choose OK. 


Adding a Window Caption 
You can add a window caption that will display in the title bar 
of the application window when you view the screen at the 
Browse level. 
_) To add a window caption: 
1. Choose Options Window Caption. 
The dialog box shown in Figure 1-13 appears. 
2. Type: 
LightShip Tutorial Screen 1 


The window caption will not appear in the title bar until 
you enter the Browse level in Exercise 5. 


Window Caption 


LightShip Tutorial Screen 1 Cancel ; 


Figure 1-13 Adding a Window Caption 


Exercise 1: Creating a Screen Background 


3. Choose OK. 


Saving the Window Position and Size 

You can save the window position and size so that your screen 
always displays as it was last saved to the file. To do this, turn 
on Options Save Window Position for the top screen, but not 
for subsequent screens. The called screens open with the 
same window position and size, which makes screen 
repainting faster and more visually pleasing. 

LJ) To save the window position and size: 


Choose Options Save Window Position. 


Saving the Screen to a File 

Now you should save your screen. If someone else might want 
to use SCREEN1.LSF as a template for the tutorial, save it with 
a new name. 

D To save the screen to a file: 


1. Choose File Save As. 


A dialog box appears and prompts you for a filename. 
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File Save As 
Filename: myscrn1|LSF 


Directory: e:\Is\tutorial 


Directories: 


Figure 1-14 Saving the Screen 
2. Make sure the \LS\TUTORIAL directory is selected. 
3. Type a filename other than SCREEN1.LSF, such as: 
myscrni.1lsf 
4. Choose OK. 
The screen is saved in the selected drive and directory. 


This is the end of Exercise 1. Go on to Exercise 2 to create 
document objects and variables. 


[Is Note Now that you have saved the file, you can close it, leave 
LightShip, and come back to the file without losing your work. 


L) To exit from LightShip: 


Choose File Exit. 


Specifying Colors 


Exercise 2: Displaying Data 


You display data in LightShip by creating document objects. A 
document object can display data from an external source, 
such as a database or a text file, or you can type directly into 
the object. 


In this exercise, you will create two document objects. One 
will display a text file and the other will display text that you 
type in from the keyboard. 


You will also define two variables. A variable is a container 
that stores value(s). You can display the values contained in a 
variable by referencing it, as you will see in this exercise. 


Setting Default Colors and Fonts 


In this section, you will select colors and fonts for the 
document objects before you create them. When you specify 
attributes for an object before creating an object of that type, 
the attributes become the defaults for that screen. Because all 
the document objects on this screen will have the same colors 
and fonts, this saves you from having to select them for each 
document object you create. 


[d] To specify the colors of a document object: 


1. Choose Tool Document. 


The cursor changes to a crosshair and the Document 
menu appears on the menu bar. 


2. Choose Document Color or press the F5 key. 


The dialog box shown in Figure 2-1 appears. 
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Specifying the 
Font 


Text Color 


Figure 2-1 Selecting Document Object Colors 


Select the dark blue-purple next to the black square in the 
upper-left corner for the text color. 


Select light gray for the background color. 
Selecting a background color that is not transparent is 
preferable for document objects because the screen 


repaints faster when you scroll. 


Choose OK. 


To specify the document’s font: 
Choose Document Font or press the Fé key. 


The dialog box shown in Figure 2-2 appears. 
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Text Font 


Sizes: 


Style 
CI Normal 
ÈI Bold 

CJ Italic 

o Underline 
C Strikeout 


C] Printer Fonts 


Size: 
C Fixed Pitch 


Text Sample: 


Figure 2-2 Selecting a Font 
When you choose fonts for document objects, the Fixed 
Pitch button is on by default. This causes only 
monospaced fonts to be listed. 
Click the Fixed Pitch check box to turn it off. 
The list box displays all fonts. 
Scroll down and select Helv from the Fonts list box. 
Select 10 from the Sizes list box. 


Select Bold in the Style list. 


Choose OK. 


2-3 
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Creating a Text File Document Object 
T To create the first document object: 
1. Make sure Tool Document is still selected. 


2. Drag the mouse from left to right across the screen to 
create the document object, as shown in Figure 2-3. 


LightShip - EALS\TUTORIAL\MYSCRNI.LSF 
File Edit Options View Special Tool Document 


» Global Industries, Inc. 


Figure 2-3 Creating the First Document Object 


3. Choose Document Source Text File. 


2-4 


6. 
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LightShip - E\LS\TUTORIAL\MYSCRN1.LSF 
File Edit Options View Special Tool Bitar 
Text File... | Source 
DDE Data Request... Layout 
User Entry... Column Delimiter 


Vertical Scroll 
“| Horizontal Scroll 


Figure 2-4 Choosing a Data Source 
The Document Text File dialog box appears. 
Make sure the LS\TUTORIAL directory is selected. 
In the Filename text box, type: 
*. txt 


Press the ENTER key to list all the files with the extension 
.TXT in the LS\TUTORIAL directory. 


Make sure the Search Path check box is turned on. 
Double-click on the file CONSOL3.TXT to select it. 


The file appears in the document object, as shown in 
Figure 2-5. 


Learning LightShip 


LightShip EALS\TUTORIAL\MYSCRNI.LSE 
File Edit Options View Special [ool Document 


© > Global Industries, Inc. 


EE OB EBA RAO USO TE E A E A T, ” 
Actual , Budget. Variance i 
31991.. 

Consolidated.. 

Sales... 

Chemical, 35823. 50000 


Figure 2-5 Displaying a Text File 


Defining Column Widths 

You can specify column widths by identifying a character in 
the source data that marks the division between columns 
(called the column delimiter). The tutorial files use a comma 
as a column delimiter. 

D To specify column delimiters and width: 


1. Choose Document Column Delimiter. 


The Column Delimiter menu appears. 


2. Choose Comma. 


This causes LightShip to begin a new column whenever it 

encounters a comma in the document object. The default 
column width is 10, which is not wide enough for the first 
column. 


Exercise 2: Displaying Data 


Choose Document Column Width. 

The dialog box shown in Figure 2-6 appears. 
Type: 

18 10 


This defines the first column as 18 characters wide and 
every subsequent column as 10 characters wide. 


Document Column Width 


Figure 2-6 Defining Column Widths 
Choose OK. 


The columns will be aligned as shown in Figure 2-7. 


LightShip - EALS\TUTORIAL\MYSCRNI.LSF 
File Edit Options View Special Tool Document 


Ò Global Industries, Inc. 


i Consolidated 
: Sales 
: Chemical 35823 50000 


: Electric 43955 33000 


Figure 2-7 The Document With Columns Aligned 
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Scrolling at the 
Author Level 


Scrolling at the 
Browse Level 


Scrolling a Document Object 


When you select a document object at the Author level, scroll 
bars appear on the LightShip window if the source has more 
text than can show in the document object. 


You will set this document object to scroll vertically one page 
at a time at the Browse level. (A page is defined by the number 
of lines displayed in the document object.) 


O To define scrolling for the document object: 
1. Click on the scroll arrow in the lower-right corner of the 


window until the word "Sales" is in the upper-left corner 
of the document. 


LightShip - E\LS\TUTORIAL\MYSCNIN | .LSF 
Eile Edit Options View Special Tool Document 


Global Industries, Inc. 


35823 50000 

43955 33000 

27783 20000 
Tota! Sales 107561 103000 


HoT LL, o eee eee A 


Figure 2-8 Scrolling the Document Object Up to "Sales" 


2. Resize the document object so that there is one blank line 
after the "Total Sales" line, as shown in Figure 2-9. 


There Should Be One 
Blank Line After "Total 
Sales" 


Exercise 2: Displaying Data 


In order for the scrolling to work correctly, the document 
object must be sized and positioned correctly. 


To resize the document: 


Place the mouse on the lower-right corner of the 
document. The cursor changes to the two-headed arrow, 
as shown in Figure 2-9. Drag the document object until it 
is the size you want. 


You may also need to reposition the document object. 
Your screen should resemble the one shown in Figure 2-9. 


LightShip - EALS\TUTORIAL\MYSCRN1.LSF 
Eile Edit Qptions Yiew Special [ool Document 


: Chemical 50000 
‘Electric 33000 
: Paper 20000 
:Total Sales 103000 


Figure 2-9 Anchoring the Top-left Corner 
Choose Document Vertical Scroll. 
This option adds vertical scroll bars to the window at the 
Browse level if the document text is larger than the 


document object. 


Choose Document Top-left Corner. 
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This sets the top-left corner so that you cannot scroll 
above or to the left of the position now showing at the 
top of the document object. 


Choose Options Scroll By Page. 
This confines scrolling to one page at a time. 


To scroll down, press the PAGEDOWN or the PGDN key one 
time. 


The document should appear as shown in Figure 2-10. 
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Figure 2-10 The Document Object 
Choose Document Bottom-right Corner. 
This sets the bottom-right corner so that you cannot scroll 
below or to the right of the position now showing at the 


bottom of the document object. 


Scroll back up to the first page by pressing the PAGEUP or 
PGUP key. 


I= Important 


Displaying Format 
Objects 


Creating a Format 
Object 


Exercise 2: Displaying Data 


It is important that the document scrolls exactly as shown in 
Figures 2-9 and 2-10 before going to the rest of the 
application. If it does not scroll correctly the first time, turn 
off all the scroll options that you set and start again at step 1 of 
this section. 


Formatting Numbers 
In this section, you will format the numbers in the document 
object that you just created. To do this you must create a 
format object. The document object affected by the format 
object is called the destination. 
Format objects are not normally displayed. That is, you cannot 
see them unless they are selected. 
L} To make a format object visible: 
Choose View Show Hidden Objects. 
The word "Format" will appear on the format object when 
you create it. 
LJ) To create the format object: 


1. Choose Tool Format. 


2. Drag the mouse to create the format object as shown in 
Figure 2-11. 
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Figure 2-11 Creating a Format Object 
3. Choose Format Destination. 


The Point mode screen appears, where you can select the 
data to format. The cursor changes to the one shown 


below: 


O To select the data: 


1. Drag the mouse over the numbers in the two columns, as 
shown in Figure 2-12. 
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LightShip: Point to H 
Clear All! Undo! $3¢-¢5¢ 


Figure 2-12 Selecting Data in Point Mode 


= Ifyou make a mistake, click Undo! or Clear All! from 
the Point mode menu bar. 


= Undo! deselects the last item you selected. You can 
click on Undo! multiple times and it will deselect 
highlighted items in the order that you selected them 
(from the last selected to the first selected). 


= Redo! reselects the items that you deselected with 
Undo! in the order that you selected them (from first 
to last). 


= Clear All! deselects all the highlighted columns. 
When you are finished, choose OK!. 

Depending on how numeric formatting is set up in the 
Windows Control Panel, you may see asterisks (*) in the 


document object instead of numbers. Asterisks mean 
there is not enough space to display the numbers. 
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Formatting 
Numbers 
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Figure 2-13 Formatting the Document Object 

You can correct this by changing the Decimal Digits setting on 
the Numeric Format dialog box. This setting defines how 
many decimal places will be displayed. 
T To open the Numeric Format dialog box: 
1. Choose Format Numeric Format or press F2. 

The dialog box shown in Figure 2-14 appears. 
2. Inthe Decimal Digits text box, type: 


0 


if it is a number other than 0. 
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Numeric Format 


1000 Separator 


Negatives Decimal Separator 
237.50 

bs en = | Decimal Digits 

Prefix 


Zero Display 
| ©.7 | 
Saro Multiplier 


Figure 2-14 Formatting Numbers 


3. Choose OK. 


The document object will be formatted, as shown in 
Figure 2-15. 
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Figure 2-15 The Formatted Document Object 


Hiding the Format m To hide the format object: 


Object 
Choose View Show Hidden Objects again. 
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Defining Variables 


Before creating the next document object, you'll define a 
couple of local variables. A variable is a container that stores 
one or more values, for example: 


report = Consolidated 


Using variables allows you a great deal of flexibility. For 
example, if report is a variable name, the value might be 
Consolidated, Chemical, Electric, or Paper. You can then refer 
to the variable and LightShip substitutes the name with the 
current value. 


Local variables are known only to the screen they are created 
on and are saved with the screen. The last value of a variable 
saved with the screen will be the initial value of the variable 
when the screen opens. 


The first variable you will create will be called repnames. It 
will contain four report names that will appear in a document 
object you'll create later in this exercise. The second variable 
will be called report and will contain the current report name. 
O To define the variables: 
1. Choose Special Variables. 
The dialog box shown in Figure 2-16 appears. The 
Variables dialog box allows you to define and delete 


variables and it displays the current value of all variables. 


2. If desired, click the Globals check box to turn off the 
display of global variables. 


When this option is off, you can only create and display 
local variables. 
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vena 
Name: Value: [_Cancet } Cancel ye 
a? |” | E 

Name = Value List: 


Display 
CO Global 
X Local 


Figure 2-16 Displaying Variables 
Click in the Name text box and type: 
repnames 
Press TAB to move to the Value text box on the right. 
Type: 
Consolidated 


and press CTRL+ENTER to create a new row. The word 
disappears, but don’t worry, it has only moved to the left. 


Do not press ENTER or you will close the dialog box. If you did 
press ENTER, choose Special Variables again, select 
repnames=Consolidated, and click in the Value text box. 
Then press the right arrow key to return to where you left off 
and press CTRL+ENTER. 


6. 


Type: 

Chemical 

and press CTRL+ENTER. 
Type: 

Electric 


and press CTRL+ENTER. 
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8. Type: 
Paper 
and press SHIFT+TAB to return to the Name text box. 
The two bars (| |) between the values indicate a new row. 
A single bar (|) indicates a new column. 
Initializing In this section, you will initialize a variable called report to the 
Variables Consolidated report. 
O To create the second variable: 
1. In the Name text box, type: 
report 
2. Press TAB to move to the text box on the right. 
3. Type: 
Consolidated 


and click in the list box below. The Variables dialog box 
appears as shown in Figure 2-17. 


Variables 


Name: Value: 
B 


Name = Value List: 


1repnames = ConsolidatedyjChemicalpjtlectricifPapet 


Figure 2-17 The Variable Dialog Box 


4. Choose OK. 
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Creating a User-Entry Document Object 


Now you will create a second document object that lists the 
names of the reports to appear in the first document object. 
Later you will create a hotspot over the list that displays the 
report you select. 


This document object will list the report names by referencing 
the variable repnames. When you reference a variable, 
LightShip substitutes the variable name with the value stored 
in the variable. You reference a variable by typing an at sign 
and enclosing the variable name in parentheses, for example, 


@(repnames). 


O To create the second document: 
1. Choose Tool Document. 


2. Drag the mouse as shown in Figure 2-18. 


LightShip - E\LS\TUTORIAL\{MYSCRN1.LSF 
File Edit Options View Special Tool Document 


©» Global Industries, Inc. 


Sales 

Chemical $35.823 $50.000 
Electric $43.955 $33.000 
Paper $27.783 $20.000 
Total Sales $107.561 $103,000 


Figure 2-18 Creating a Second Document Object 
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3. Double-click on the document to display the Document 
Source menu. 
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Figure 2-19 Selecting a Document Source 
4. Choose User Entry. 


A flashing vertical bar appears in the object. 
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Figure 2-20 Typing a Variable Reference 


Type: 
@(repnames) 
and press ENTER. 


The report names appear in the document object, as 
shown in Figure 2-21. 
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Figure 2-21 The Second Document Object 
6. Resize the document object so that there is no blank line 
after "Paper." 
This is the end of the second exercise. 
Choose File Save to save the file before going on to the next 


exercise, which shows you how to create text and draw 
objects. 
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Exercise 3: Displaying Text and Draw Objects 
This exercise shows you how to create text objects and draw 
objects. Most documents display "live" data, that is, data from 
other sources, while the text in a text object is usually saved 
with the file. You use text objects to display small amounts of 
text, such as headers. 


In this exercise, you will create three text objects and one 
draw object. 


Setting Default Colors and Fonts 
In this section, you'll set the default colors and fonts for the 
text objects. 
O To specify the text colors: 
1. Choose Tool Text. 
2. Press F5. 
A dialog box appears. 


3. Select the purple square in the second row and second 
column from the top-left corner, as shown in Figure 3-1. 
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Specifying the 
Font 


Figure 3-1 The Text Color Dialog Box 


4. Select Transparent as the background color. 


5. Choose OK. 


O To specify the font: 
1. Press F6. 
2. Select Helv, 12, Bold. 


3. Choose OK. 


Creating Text Objects 

In this section, you will create the headers for the document 
objects. The first text object will reference the variable report 
that you created in the last exercise, so that it will display the 
name of the current report. 


O To create the first text object: 


1. Drag the mouse over the area shown in Figure 3-2. 


Exercise 3: Creating Text and Draw Objects 


You might have to move and resize the document object 
so that the text object will fit. 
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Figure 3-2 Creating the First Text Object 
To enter the text, choose Text Text. 
The dialog box shown in Figure 3-3 appears. 
Type: 
@(report) Sales Report 


Choose OK. 


@{(report) Sales Report 


Figure 3-3 Entering Text 
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You might have to resize the text object so the text will fit. 
The text object should appear as shown in Figure 3-4. 
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Figure 3-4 The First Text Object 


Creating the The second text object will display headers for the actual and 
Second Text budget columns. 
Object 


O To create the second text object: 

1. Make sure the text object you just created is selected. 
2. Choose Edit Copy. 

3. Choose Edit Paste. 


This makes a copy of the text object, as shown in 
Figure 3-5. 
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Figure 3-5 Copying the Text Object 


Double-click on the new text object to open the Text 
dialog box. 


Type: 

Actual 

Space over seven characters and type: 
Budget 

Choose OK. 


Resize the text object and drag it so that it is above the 
actual and budget columns of the document object. 


If necessary, move the document object to make space for 
the text object. 
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Figure 3-6 The Second Text Object 

The third text object will display a header for the list of reports 
shown in the user-entry document object. 
(J To create the third text object: 
1. Make sure the second text object you created is selected. 
2. Press INS. 
3. Choose Text Text or press F2. 
4. Type: 

Reports 
5. Choose OK. 


6. Resize the text object and place it above the user-entry 
document object, as shown in Figure 3-7. 


Exercise 3: Creating Text and Draw Objects 
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Figure 3-7 The Third Text Object 


Creating a Draw Object 


Now you will create a draw object to outline the "Consolidated 
Sales Report" text object. 


Lj To create a draw object: 

1. Choose Tool Draw. 

2. Choose Draw Shape Round Rectangle. 
3. Choose Draw Border Other. 


The dialog box shown in Figure 3-8 appears. 
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Other Thickness 


Thickness: no | 


Figure 3-8 Customizing Border Thickness 
4. Type: 
1 
5. Choose OK. 


6. Drag the rectangle around the text object, as shown in 
Figure 3-9. 
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Figure 3-9 Drawing an Outline 
7. Press Fs. 


8. Double-click on the black square. 
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This is the end of the third exercise. Choose File Save to save 
the file before going to the next exercise, which shows you 
how to perform a calculation and display the results. 


Exercise 4: Calculating Variances 


In this exercise you will subtract the budget figures from the 
actual figures to produce variance numbers. 


You will store the numbers in a variable, which will be 
displayed in a user-entry document. This makes the variance 
data dynamic; it changes when the actual and budget figures 
change. 


In the last part of the exercise, you will see how the order of 
objects affects how calculations are performed. 


Creating a Menu Object 


You'll use a special menu object, called &&Recalc, to perform 
the subtraction. This object is provided by LightShip and does 
not display on the screen. You can define actions for it, which 
are executed when the following events occur: 


A screen opens. 

A request for external data is issued. 

A Calculate Now is issued. 

A document object is scrolled. 

A variable that is the result of the actions is referenced. 


m 


To create the menu object: 


— 


Choose View Show Hidden Objects. 
2. Choose Tool Menu. 


Drag the mouse across the screen, as shown in Figure 4-1. 
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Figure 4-1 Creating a Menu Object 
3. Choose Menu Names. 
The dialog box shown in Figure 4-2 appears. 
4. Inthe Menu Bar text box, type: 


&&Recalc 


Menu Names 


Menu Bar: [k&Recalc 


Menu Item: | 


O Insert Separator 


Figure 4-2 Defining Menu Names 


5. Choose OK. 
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Defining the Menu In this section, you’ll define the menu ation. 
Action 
O To define the menu action: 


1. Choose Menu Actions. 


A dialog box appears. 


Action Description: 


Figure 4-3 Defining Menu Actions 
2. Choose the Function button in the lower-right corner. 
A dialog box appears. 


Function Action 


Result Variable 


eS | 


CO Don't Store Result 


Figure 4-4 Defining a Function 


Learning LightShip 


Defining a Result Lj First, define the result variable: 
Variable 
1. In the Result Variable text box, type: 


variance 


Function Action 


Result Variable 


[variance] J 


oO Don't Store Result 


:= (Copy/Test variable 

& (Concatenate strings) 

&& (Concat with space) 
CONTAINS (String within string} 
DATE (Current date) 

EXISTS (File exists? 


® String 


Figure 4-5 Defining the Result Variable 


Selecting a The string functions are listed in the Operation list box. 
Function 
2. Choose Numeric to display the list of numeric functions. 


Function Action 


Result Variable 


O Don't Store Result 1. Number = 


2. Number = 
:= (Copy/Test variable) 
+ [Addition 


ABS [Absolute Value 
O String ® Numeric 


Figure 4-6 Selecting a Numeric Function 


3. Select -(Subtraction). 
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Specifying Now you need to specify the data for the first argument, which 
Arguments is already selected in the Argument(s) list box. You will define 
the first argument by pointing to the actual column in the 
document object. 
LJ) To select the arguments: 
1. Choose the Point button. 


The screen changes to Point mode. 


2. Select the actual figures as shown in Figure 4-7. 


Lightship: Point ta Function Parameter 1 


OK! Cancel! 


Figure 4-7 Specifying the First Argument 
3. Choose OK!. 


4. Select the second number in the Argument(s) list box, as 
shown in Figure 4-8. 
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Function Action 


Result Variable 


ns 


C Don't Store Result 
Operation 


2. Number = 


:= (Copy/Test variable) | +3 

+ [Addition E 

- (Subtraction 

* (Multiplication) | 

/ (Division) 

ABS [Absolute Value [+3 
© Sting ®© Numeric 


Figure 4-8 Selecting the Second Argument 


5. Choose Point. 


6. Select the budget figures, as shown in Figure 4-9. 


LightShip: Point to Function Parameter 2 
Clear All! Undo! & OK! Cancel! 


Sales 
2° Chemical 35823 Chemical 
Electric 43955 TERETE 
Paper 27783 = paper 
ae Total Sales 3 _ 107561 mec: 


Consolidat 


Figure 4-9 Specifying the Second Argument 
7. Choose OK! 


8. Choose OK to close the Function Action dialog box. 
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The function is displayed in the Actions list box, as shown 
in Figure 4-10. 


Menu Action 


Actions: 
1 variance := 


Paste 


Function variance := (Point) - (Point) 


Action Description: 

Display Retrace Path 

DOS Command - Show Minimized 
DOS Command - Show Normal 
Execute Menu 


File Write Text A 


Figure 4-10 The Menu Action 


Replace 


9. Choose OK to close the Menu Action dialog box. 


Creating a User-Entry Document Object 


In this section you will create a user-entry document object in 
which you'll display the variance numbers by referencing the 
variable, @(variance). The reason you need to display these 
numbers in a document object is because in a later exercise, 
you will create a chart of the variances. To chart them, you 
must be able to select the numbers on the Point mode screen; 
and to select numbers in Point mode they must be displayed in 
a document object. Later, you can hide the document object 
so that it does not show on the application screen. Hidden 
document objects do not show on the screen except in Point 
mode. 


O To create the user-entry document object: 


1. Choose Tool Document. 
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Drag the mouse in the top-right corner of the screen, as 
shown in Figure 4-11. 
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Figure 4-11 Creating a User-Entry Document 


2. Double-click on the object or press F2 to display the 
Document Source menu. 


3. Choose User Entry. 
4. Type: 

@ (variance) 
5. Press ENTER. 


Now resize the @(variance) user-entry document so that the 
column of numbers shows in the object window. 
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Figure 4-12 Displaying the Variance Figures 


Ordering the Objects 


At this point, if you close and open the screen or if you select 
the text file for the document object again, the value of 
variance will not be calculated or displayed in the user-entry 
document. This is because of the order of the objects. 


LightShip objects are ordered in relation to each other. This 
order affects both the behavior and appearance of an 
application. Objects are evaluated from front to back, that is, 
the object that is in front of all others is evaluated first. If an 
object has actions, the actions are executed at the time the 
object is evaluated. 


The calculation that the &&Recalc menu object will perform is 
a good illustration of how the order of objects can affect the 
behavior of an application. For this calculation to work 
correctly, the document object used as the source for the 
calculation must be in front of the &&Recalc menu object so 
that its data is displayed before the &&Recalc menu object 
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points to it. Otherwise the &&Recalc object will be pointing at 
blank space or incorrect values. Also, the &&Recalc menu 
object must be in front of the user-entry document that 
displays the result, so that the results are calculated before the 
variable substitution occurs. 


If you created the objects in the order given in the exercise, 
they need to be reordered. Because objects are usually 
created from front to back, the first object you created is the 
furthest back and the last to be loaded (if it has source data) or 
the last to be executed (if the object has actions). 


O To reorder the objects: 


1. Select the object with the @(variance) reference and 
choose Special Bring to Front. 


2. Select the &&Recalc menu object and choose Special 
Bring to Front. 
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Actual Budget 


Object 
Sales Consolidated 
Chemical $35,823 Chemical 
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3. The Text File Paper $27.783 ; Paper 


Document Object Total Sales $107,561 


4. The Text Object 


Figure 4-13 Reordering the Objects 
3. Select the document object that displays the actual and 
budget figures and choose Special Bring to Front. 
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Document Object 


Exercise 4: Calculating Variances 


The text object with the Actual and Budget titles will 
disappear behind the document object. 


Select the text object by clicking in the document object at 
the point where the text object is displayed behind it. 


Press CTRL+UP ARROW until you see the Text menu displayed 
on the menu bar, and then choose Special Bring to Front. 


The calculation occurred the first time because the text 
document object was already loaded with data and the variable 
variance was referenced. Because Special Calculation 
Automatic is on by default, the referencing of the variable 
caused the &&Recalc’s actions to be executed. 


Now you can hide the document object that displays the 
variance numbers. 


= 
1. 


4. 


To hide the document object: 


Select the document object that displays the variance 
numbers. 


Choose Document Hidden. 


Choose View Show Hidden Objects to turn off the display 
of hidden objects. 


Choose File Save. 


This is the end of Exercise 4. Go on to the next exercise to 
learn how to create a hotspot that displays different text files 
in a document object. 


This Text Object Will 
Change Dynamically 


The Text File in the 
Document Object Will 
Change Dynamically 


You Will Create a 
Hotspot In Front of the 
User-Entry Document 
Object 
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Exercise 5: Displaying Text Files Dynamically 


In this exercise, you will create a hotspot so that when you 
click on an item in the user-entry document object, the sales 
report for that item will appear in the text file document 
object and the corresponding report name will appear in the 
text object header. 


LightShip - EALS\TUTORIAL \MYSCHRN1.1 SE 
File Edit Options View Special Tool 


Global Industries, Inc. 


Consolidated Sales Report 


Reports 
Actual Budget 
Sales Chemical 


Chemical $35,823 $50,000 Consolidated 
Electric $43.955 $33.000 Electric 
Paper $27.783 $20.000 Paper 

Total Sales $107.561 $103.000 


Figure 5-1 The First Screen 


You'll start by defining a variable called data that will contain 
the filenames that can be displayed. Like repnames, this 
variable will have one column with four rows. The filenames 
will correspond to the report names in the user-entry 
document. For example: 


Files (data) Reports (repnames) 
consol3 Consolidated 

chem3 Chemical 

elect3 Electric 

paper3 Paper 
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The hotspot will be in front of the user-entry document. You 
will define it with the MOUSEROW function to return the row 
number that you click on. Once you know the row that was 
clicked on, you can use the FETCH function to get the correct 
filename from data and correct report name from repnames. 


The steps will be: 


= Define the variables. 

= Define the hotspot and the hotspot actions. 

a Change the text file document object source so that it is a 
variable reference. 


Defining the Variables 
In this section, you'll define two local variables much like 
repnames and report. One will be called data and it will 
contain all the filenames. The other will be called datafile and 
it will contain the currently selected filename. 
_} To define the variables: 
1. Choose Special Variables. 

The Variables dialog box appears. 


2. Ifdesired, click the Globals check box to turn off the 
display of global variables. 


3. Inthe Name text box, type: 
data 

4. Press TAB to move to the text box on the right and type: 
consol3 


and press CTRL+ENTER. 
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5. Type: 
chem3 
and press CTRL+ENTER. 
6. Type: 
elect3 
and press CTRL+ENTER. 
7. Type: 
paper3 
and click in the list box below to display the definition. 
The dialog box should resemble Figure 5-2. 


Variables 
Name: Value: 


ba [8] [eonsory S 


Name = Value List: 


Figure 5-2 Displaying Variables 


Initializing a Now, initialize datafile to the consolidated report. 
Variable 
O To create the second variable: 
1. Inthe Name text box, type: 
datafile 


2. Press TAB to move to the text box on the right. 
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4. 


Type: 
consol3 
and click in the list box below to display the definition. 


The Variables dialog box should appear as shown in 
Figure 5-3. 


Variables 


Name: 


data = consol3lichem3ilelect3ilpaper3 


datafile = consol3 


sol3 


on: = 
variance = -141771109551778314561 D abal 
Zl Local 


Figure 5-3 The Current Variable Values 


Choose OK. 


Creating a Hotspot 


In this section you will create the hotspot. 


m 
l; 


To create the hotspot: 
Choose View Outline All Objects. 
Choose Tool Hotspot. 


Position the crossbar cursor on the upper-left corner of 
the user-entry document object outline. 


4. 
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Reports 


Í ‘Consolidated 


‘Chemical 
‘Electric 
‘Paper 


Figure 5-4 Creating the Hotspot 


Then drag the mouse over the document object, as shown 
in Figure 5-5. 


Make sure the hotspot is the same size or slightly smaller 
than the document object. If the hotspot is larger than 
the document object and you click on it in an area outside 
of a document cell, the MOUSEROW function will return a 


Zero. 


LightShip - E\LS\TUTORIAL\MYSCRN1.LSF 
File Edit Options View Special Tool Hotspot 


ee Sales Report) 
Actual Budget ? 
Sales ; hemical 
‘Chemical $35.823 $50,000 Consolidate 
‘Electric $43.955 $33.000 lectric 
‘Paper $27.783 $20,000 


‘Total Sales $107,561 $103,000 
iS 


Figure 5-5 Creating a Hotspot 


Turn off View Outline All Objects. 
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Defining the O To define the hotspot actions: 
Hotspot Actions 
1. Make sure the hotspot is selected. 
2. Choose Hotspot Actions. 
The Hotspot Action dialog box appears. 
3. Choose the Function button in the lower-right corner. 
The Function Action dialog box appears. This time you 


will use String functions. 


Defining the Result In the Result Variable text box, type: 


Variable 
row 
When you click on an item in the document object, row will 
contain the number of the row on which you clicked. 
Selecting the The MOUSEROW function returns the row number that you 
MOUSEROW click on. 
Function 


= Click in the Operation list box, type "m", and press the 
DOWN ARROW key until you select MOUSEROW. 


Or 


= Scroll down and select MOUSEROW from the Operation 
list box. 


The dialog box should look like Figure 5-6. 
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Function Action 


Result Variable 


CO Don't Store Result 


EXISTSAPP [Application executing?) 
FETCH (Cell by row/column) 

LEN (String character length) 
LOOKUP (String matches cell} 


MOUSEROW [Cell row] 
® String © Numeric 


Figure 5-6 The Hotspot Action Dialog Box 


Specifying the MOUSEROW has only one argument, which is already selected 
Argument in the Argument(s) list box. 
O To specify the argument: 
1. Choose Point. 
The Point mode screen appears. 
2. Select the items in the user-entry document object, as 
shown in Figure 5-7. 
3. Choose OK!. 
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LightShip: Point to Function Parameter 1 
OK! Cancel! 


~ Sales 
Chemical 35823 s0000 
Electric 43955 33000 
Paper 27783 20000 
Total Sales 107561 103000 


Figure 5-7 Specifying a Cell Range as an Argument 
4. Choose OK to close the Function Action dialog box. 


The function is displayed in the Actions list box as shown 
in Figure 5-8. 


Hotspot Action 


Actions: 


1 row -= MOUSEROW/([Point 
End 


Action Description: 

Display Retrace Path 

DOS Command - Show Minimized 
DOS Command - Show Normal 
Execute Menu 


fnser 


Figure 5-8 The Hotspot Action Dialog Box 


Specifying the 
FETCH Functions 


Exercise 5: Displaying Text Files Dynamically 


The FETCH function gets the value of a specified row and 
column in a variable. Once MOUSEROW has gotten the row 
number of the cell you've clicked on, you can use it in the 
FETCH function to get the appropriate values out of repnames 
and data. Both repnames and data are only one column, so 
we know the column number is one. 


We want the FETCH functions to follow the MOUSEROW 
function. 


Q To specify the FETCH functions: 


1. Make sure END is selected in the Actions list box so that 
the new action will be inserted above it in the list. 


2. Choose Function. 


3. Click the down arrow next to the Result Variable text box 
and select report, as shown in Figure 5-9. 


Function Action 


1. Cells String = 
2. Row Number = 
3. Column Number = 


Figure 5-9 Selecting a Result Variable from the List 
4. Now click in the Operations list box and press the letter 
"F" on your keyboard to go to the first operation that 
Starts with "F." 


This selects FETCH. 
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5. For the first argument, select repnames from the drop- 
down list, as shown in Figure 5-10. 


Function Action 


Besult Variable 


report 
CO Don't Store Result 


&& (Concat with space) 
CONTAINS (String within string) 
DATE (Current date} 


® String © Numeric 


Figure 5-10 Selecting an Argument from the List 


6. Select the second argument, Row Number, and in the 
arguments text box, type: 


row 


Function Action 


Result Variable 


Argument(s) 
CO Don't Store Result 1. Cells String = repnames 


. Row Number = 
3. Column Number = 


&& (Concat with space) 
CONTAINS (String within string) 
DATE (Current date) 
EXISTS [File exists?) 

App 


@ Sting © Numeric 


Figure 5-11 Typing an Argument 


7. Select the third argument, Column Number, and in the 
arguments text box, type: 


1 
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Copying and 
Editing a Function 


8. 
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Choose OK. 
The dialog box should look like Figure 5-12. 


Hotspot Action 


1 row := wn ee 
H 


Action Description: 

Display Retrace Path 

DOS Command - Show Minimized 
DOS Command - Show Normal 
Execute Menu 

File Write Text 

Function 


Figure 5-12 The Hotspot Action Dialog Box 


Now you can copy and edit this function, since the next 
FETCH function performs the same operation on data. 


L} To copy and edit a function: 


I; 


Make sure the "report: =FETCH..." line is selected in the 
Actions list box. 


Choose the Cut button. 
Choose the Paste button twice. 


There should be two "report: =FETCH..." lines in the 
Actions list box. 


Select the second one. 


Choose the Replace button. 
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The Function Action dialog box appears. 
For the result variable, select or type: 
datafile 

For the first argument, select or type: 


data 


Function Action 


Result Variable 


Argument{s) 


C Don't Store Result 1. Cells String = data 
2. Row Number = row 
3. Column Number = 1 


&& (Concat with space) 
CONTAINS (String within string) 
DATE (Current date) 


@s String O Numeric 


Figure 5-13 Specifing a Result Variable 
Choose OK. 


The dialog box should resemble Figure 5-14. 
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Hotspot Action 


Actions: 
1_row := MOUSEROW/[Point 
2 report := FETCH{repnames. row. 1) 
3 datafile := FETCH{data. row. 1) 
End 


Function row := MOUSEROW([[Point)) 


Action Description: 

Display Retrace Path 

DOS Command - Show Minimized 

DOS Command - Show Normal 

E ute M Replace 


File Write Text s 


Figure 5-14 Editing a Function 


9. Choose OK. 


Referencing Variables 


Before you can test these functions, you need to put the 
variable reference in the Document Text File dialog box. 


1. Select the document object with the actual and budget 
figures and press Fe. 


2. Choose Text File as the document object’s source. 
The Document Text File dialog box appears. 
3. Inthe Filename text box, type: 


@ (datafile) .txt 
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Document Text File 
Filename: @(datafile). TXT 


Directory:  e:\Is\tutorial 


Directories: 


EX] Search Path 


Figure 5-15 Specifying a Text File 


4. Choose OK. 


Testing the Hotspot 


To test the hotspot, you must go to the Browse level. 


Q To test the hotspot: 


1. 


Choose Special Author or press the F4 key. 


Notice that the menu bar changes to the Browse level 
menu bar. 


Move the cursor over the hotspot that is in front of the 
Report names and click on each one of the items. 


The text file in the document object and the text in the 
header should change. 


Exercise 5: Displaying Text Files Dynamically 


[I> If You Have If the text file or header doesn’t change, check the following: 
Problems 
m Make sure the values of repnames and data are correct 
and that they are separated by CTRL+ENTER. 


m Make sure the Document Text File dialog box is 
referencing @(datafile).TXT and the text object is 
referencing @ (report). 


m Make sure the hotspot is the same size or slightly smaller 
than the document object. 


m Make sure that the MOUSEROW function is pointing only 
to the list items shown in Figure 5-7 and not to any blank 
lines. 

= To see if row and other parameters are being set correctly, 


use the Debug window. For more information on Debug, 
see the next section. 


The Debug The Debug window lets you list objects, and trace actions, 
Window variables, and parameters. 

_) To open the Debug window: 

1. Make sure you are at the Author level. 

2. Choose Special Debug. 


The Debug window opens, as shown in Figure 5-16. 
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=l LightShip Tutorial Screen 1 Re 
File Edit Special 


LightShip Debug 


File Edit Options... Objects List! Variables List! Palette Listi 
ACT: Executing Acotione for Object WO 
Parametere: 
1: Function row := MOUSEROW((Point)) 
> row:=2 
2: Function report := FETCH(repnames, 
: repnames=>Consolidated 
: Chemical 
>: Electric 


: Paper 
= row=>2 
z: report:=Chemical 


3: Function datafile := FETCH(data, 

data=>coneol3 

: ohem3 

: elect3 

: paper3 

> row=>2 
datafile:=chem3 

: variance=>-877 

: 2039 

z -572 

: 590 
variance=>-877 

: 2039 

: -572 


Figure 5-16 The Debug Window 


3. Choose Options on the Debug window and make sure 
Local Parameters is turned on. 


Debug Options 


i 
KX] Local Parameters [__Cance! | 


Èg Actions 


Output 


ÈJ Window, Lines 
Ome ÇC |] 


Figure 5-17 Setting Debug Options 


4. Choose OK. 
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Using the Windows Control menu, choose Control Switch 
to LightShip. 


Press F4 to go to the Browse level. 
Click on an item in the list. 
Choose Control Switch to LightShip Debug. 


Look to see if row is being set to the correct value. 


10. When you are finished, press F4 to return to the Author 


level. 


This is the end of Exercise 5. Before going on to Exercise 6, 
make sure Consolidated is selected and then save the file. 


Exercise 6: Creating Charts 
In this exercise, you will create two charts. One chart will 
show the actual and budget figures from the text file 


document object, and the other chart will show the variances 
from the user-entry document object. 


Creating the First Chart 
O To create a chart: 
1. Choose Tool Chart. 


2. Drag the mouse over the area shown in Figure 6-1. 


LightShip - EALS\TUTORIAL\MYSCIIN1.LSE 
Eile Edit Qptions Yiew Special [ool Chart Help 
[+ 


©> Global Industries, Inc. 
( Consolidated Sales Report} 


Actual Budget 
Sales Consolidated 
Chemical $35.823 $50.000 Chemical 
Electric $43.955 $33.000 Electric 
Paper $27.783 $20.000 Paper 
Total Sales $107.561 $103,000 


Reports 


Figure 6-1 Creating a Chart 
3. Choose Chart Data New Series. 


The Point mode screen appears. 
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Selecting the First 
Data Series 


á. 
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tip: Point to 1st Chart Data 


Sales i 
Chemi cal 35823 : Consolidat 
Electric 43955 Sikina 
Paper 27783 3H 

Total Sales 107561 1030 Paper 


Figure 6-2 Selecting the First Data Series 


Select the first three numbers in the budget column, as 
shown in Figure 6-2 and choose OK! 


LightShip - EALS\TUTORIAL\MYSCRNI.LSF 
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Gg 
©) Global Industries, Inc. 


Sales Actual Budget Consolidated 
Chemical $35,823 $50.000 Chemical 
Electric $43.955 $33.000 Electric 
Paper $27,783 $20.000 Paper 


Reports 


Total Sales $107.561 $103,000 


Figure 6-3 The Chart Appears on the Screen 
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Selecting the Now, select the actual numbers for the second data series. 


Second Data 
1. Choose Chart Data New Series. 


Note that the menu now shows "1st" for the first data 
series and "New Series", so that you can select a new 
series. 


2. Select the first three numbers in the actual column. 


LightShip: Point to 2nd Chart Data 
Clear All! Undo! ge OK! Cancel! 


Cansolidat 
Chemical 
Electric 


Paper 
Total Sales 107561 103000 Paper 


Figure 6-4 Selecting the Second Data Series 


3. Choose OK! 
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LightShip - EALS\TUTORIAL\MYSCRN1.LSF 
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Global Industries, Inc. 


Consolidated Sales Report 
Reports 


Actual Budget 


Sales Consolidated 
Chemical $35.823 $50.000 Chemical 
Electric $43.955 $33.000 Electric 
Paper $27.783 $20,000 Paper 

Total Sales $107.561 $103.000 


Figure 6-5 The Second Data Series is Charted 


Changing the Chart Type 

Bar charts are the default chart type. In this section, you'll 
change the first data series so that it will show to a better 
advantage. 

Q To change a chart type: 

1. Choose Chart Type. 


The dialog box shown in Figure 6-6 appears. 
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Bar Line Area Pie 


Chart Type 
Series 


ðO Horizontal 


Figure 6-6 Changing a Chart Type 
Leaving the 1st button selected, select the area chart icon. 
In the % Width text box, type: 
80 
Choose the 2nd button. 
Leave the bar chart icon selected. 
In the % Width text box, type: 
40 


Choose OK. 
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Changing the Chart Colors 


In this section you will color the various chart items. Even 
though not all the items are defined yet, you will specify the 
colors for all the items while the color dialog box is open. 


Ik Note If you are in a hurry, you can skip this and go on to the next 


section. 
J) To change the color of chart items: 
1. Choose Chart Color or press F5. 


The dialog box shown in Figure 6-7 appears. 


2. Select Plot Area and then select dark blue-purple. 


Chart Colors: 


Select the Item to Color Background Area + 


Plot Area 


Here 


Figure 6-7 Coloring Chart Items 


10. 
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Select Legend and then select dark red-purple 
(underneath the dark blue-purple) in the Foreground box. 


Select Outline and then select white. 

Select 1st Chart Data and then select bright blue. 
Select 2nd Chart Data and then select gray-green. 
Select Numeric Label and then select dark blue-purple. 
Select Numeric Axis and then select white. 

Select Numeric Crosses Line and then select white. 
Select Category Axis and then select white. 


Choose OK to enter your selections and close the dialog 
box. 


Your screen should resemble Figure 6-8. 
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Global Industries, Inc. 
{ Consolidated Sales Report } 


Actual Budget 


Sales Consolidated 


Chemical $35.823 $50.000 Chemical 
Electric $43,955 $33.000 Electric 
Paper $27.783 $20.000 Paper 


Total Sales $107.561 $103,000 


Figure 6-8 The First Chart 
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Copying the 
Document Object 


eee 
Displaying a Legend 


The chart legend identifies the data being charted. For 
example, this chart shows budget and actual data. Because 
you will need to select the legend from a document object in 
Point mode, you'll copy the text file document object. This 
has the text that you need for the legend. You will scroll up to 
that line and then hide the document object. You do not 
forfeit performance because the document object is loaded 
with data only one time. 


m) 
L 


To copy the document object: 


Select the document object with the actual and budget 
figures and press the INS key. 


This document has the same attributes as the original so 
you must change them. 


Press F5 and double-click on white as the background 
color. 


Resize the new document object so that only the "Sales" 
line shows. 


Drag it as shown in Figure 6-9. 


Choose Document Top-left Corner to turn it off. 


6. 


lightShip - E4 S\LUTORIAI\MYSCHN1.I SE 
Eile Edit Options Yiew Special [ool 


Exercise 6: Creating Charts 


Cl babies C- 


Consolidated Expenses Report 


Sato Actual 
Chemical $35.823 
Electric $43.955 


Paper $27.783 
Total Sales $107,561 


Budget 


$50.000 
$33.000 
$20.000 
$103,000 


Consolidated 
Chemical 
Electric 
Paper 


Figure 6-9 Copying the Document Object 
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Document 


{ Consolidated Expenses Report 


Salus Actual 


Chemical $35.823 
Electric $43.955 


Paper $27.783 
Total Sales $107,561 


Budget 


$50.000 
$33,000 
$20.000 
$103,000 


Scroll up three lines until the object displays "Actual 
Budget Variance," as shown in Figure 6-10. 


Consolidated 
Chemical 
Electric 
Paper 


Figure 6-10 Preparing the Legends 
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7. Choose Document Vertical Scroll to turn off vertical 
scrolling. 


8. Choose Document Hidden to hide the document object. 


Selecting the O To select the legend: 
Legend 
1. Select the chart. 


2. Choose Chart Legends. 
The Point mode screen appears. 
3. Select "Budget," as shown in Figure 6-11. 


4. Then select "Actual," as shown in Figure 6-11. 


LightShip: Point to Chart Legends 
Clear All! Undo! 


se 
Chemical 35823 50000 
Electric 43955 33000 
Pape 27783 20000 


r 
Total Sales 107561 103000 


Figure 6-11 Selecting the Legend in Point Mode 


5. Choose OK! 
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Global Industries, Inc. 


Sales Actual Budget Consolidated 
Chemical $35.823 $50,000 Chemical 
Electric $43.955 $33., 000 Electric 
Paper $27.783 $20,000 Paper 

Total Sales $107,561 $103.000 


Figure 6-12 The Legend Appears on the Chart 


6. Resize the chart so that it is almost as large as the image 
object frame, while staying on the left side. 


7. Reposition the chart as needed. 


Creating the Second Chart 


The second chart will graph the variance numbers. You can 
create the second chart by copying the first one. 


O To create the second chart: 
1. Select the chart and press INS. 


2. Drag the copy of the chart over to the right, as shown in 
Figure 6-13. 
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Consolidated Sales Report 
Reports 


Actual Budget Consolidated 


Sales 


Chemicai $35.823 $50.000 Chemical 
Electric $43.955 $33.000 Electric 
Paper $27.783 $20.000 Paper 


Total Sales $107.561 $103,000 


Figure 6-13 Creating the Second Chart 
Choose Chart Data 2nd. 
The Point mode screen appears. 
Choose Undo! 
The selected area clears. 
Choose OK! 
Choose Chart Data 1st. 
The Point mode screen appears. 
Choose Undo! 
The selected area clears. 


Select the first three variance numbers, as shown in Figure 
6-14. 
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LightShip: Point to Chart litle 
Clear All! Undo! Reis? OK! Cancel! 


Sal es 
“Chemical 35823 50000 
SElectric 43955 33000 
Paper 27783 20000 
Total Sales 107561 103000 


Figure 6-14 Selecting the Variance Numbers 
Choose OK! 


Your screen should resemble Figure 6-15. 
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Global Industries, Inc. 
(‘Consolidated Sales Report ) ne 


Actual Budget 


Sales Consolidated 


Chemical $35.823 $50.000 Chemical 
Electric $43.955 $33,000 Electric 
Paper $27.783 $20.000 Paper 


Total Sales $107.561 $103,000 


Figure 6-15 The Second Chart 
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Changing the 
Chart Type 


Now you'll make this chart a horizontal bar chart. 


m 
1. 


To change the chart type: 
Choose Chart Type. 

Select the bar chart icon. 

Click in the % Width box and type: 
50 

Turn on the Horizontal check box. 


Choose OK. 


l Consolidated Sales Report 


Actual Budget 


Sales Consolidated 


Chemical $35.823 $50,000 Chemical 
Electric $43.955 $33,000 Electric 
Paper $27.783 $20,000 Paper 


Total Sales $107.561 $103,000 


Figure 6-16 A Horizontal Bar Chart 
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Displaying a In this section, you will select the legend. 
Legend 
Q To select the legend: 
1. Choose Chart Legends. 
The Point mode screen appears. 
2. Choose Clear All! 


3. Select "Variance," as shown in Figure 6-17. 


> Chemical 35823 50000 
‘Electric 43955 33000 
: 27783 20000 


Paper 
‘Total Sales 107561 103000 


Figure 6-17 Selecting the Legend 


4. Choose OK! 
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l Consolidated Sales Report 


Actual Budget 


Sales Consolidated 


Chemical $35.823 $50.000 Chemical 
Electric $43.955 $33,000 Electric 
Paper $27.783 $20.000 Paper 


Total Sales $107.561 $103,000 


Figure 6-18 The Legend Appears on the Chart 


Changing Colors Now you’ll change the color of the data. 
Q To change a color: 
1. Press F5. 
The Chart Color dialog box appears. 


2. Choose 1st Chart Data and then double-click on bright 
pink. 


Testing the Charts 


Now go to the Browse level and see if the charts change when 
you scroll the document object. 


O To test the charts: 


1. Choose Special Author or press F4. 
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Press PAGEDOWN or PGDN. 


The document object with the actual and budget figures 
should scroll down, the variances should recalculate for 
the second page of the document object, and the charts 
should change. 


lightShip Lutarial Screen 1 


File Edit Special 


Global Industries, Inc. 
( Consolidated Sales Report } es 


Expenses Actual Budget Consolidated 
Chemical $31.590 $31.000 Chemical 


Electric $32.660 $30,000 Electric 
Paper $24.449 $20.000 Paper 


Total Expenses $88.699 $81.000 


Figure 6-19 The Consolidated Expenses Report 
Press PAGEUP or PGUP. 
The document object should scroll up, the variances 
should recalculate for the first page of the document 
object, and the charts should change. 
Select "Chemical." 
Press PAGEDOWN or PGDN. 
The document object should scroll down, the variances 


should recalculate for the second page of the document 
object, and the charts should change. 
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Global Industries, Inc. 
(__ Chemical Sales Report) — 


Expenses Actual Budget Consolidated 
R&D $6.123 $7.000 Chemical 
Mktg. $11.039 $9,000 Electric 
Admin. $14.428 $15, 000 Paper 

Total Expenses $31.590 $31.000 


Figure 6-20 The Chemical Expenses Report 


If the screen does not update as shown, refer to "Ordering the 
Objects" in Exercise 3, and "Testing the Hotspot" in Exercise 5: 


6. Make sure Consolidated is selected. 
7. Choose Special Author or press F4. 
8. Choose File Save or press F9 to save the file. 
This saves the screen with report and datafile initialized 


to the consolidated values. 


This is end of Exercise 6. Proceed to the next exercise to see 
how to go to another screen. 


Exercise 7: Going to Another Screen 


You will set up this application so that when you click on the 
text file document object, you will open another screen that 
displays a chart for the current division. This screen, 
SCREEN2.LSF, is provided. The chart on this screen displays 
five years worth of sales and expense totals. 


In this exercise, you will create a hotspot on the text file 
document object. The hotspot will open the second screen 
and pass parameters to it that contain information about the 
current division or consolidated report. 


The files for the second screen have the same names as the 
files for the first screen, except they have an "a" on the end. 
The files are called: 


CONSOL3A 
CHEM3A 
ELECT3A 
PAPER3A 


The source for the document object on SCREEN2.LSF is 
referenced in the Document Text File dialog box as 
@(datafile)a.txt. 


Creating a Hotspot 

You can open the second screen and pass parameters by 
creating a hotspot. This hotspot will be in front of the text file 
document object. 

Q To create the hotspot: 

1. Choose Tool Hotspot. 


Drag the mouse across the document object, as shown in 
Figure 7-1. 
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Global Industries, Inc. 
ae 


Hitro OUdGe 


: Chemical $35,823 $50.000 : Consolidated 

: Electric $43.955 $33.000 É Chemical 
Paper $27.783 $20.000 Ë Electric 
Total Sales $107.561 $103,000 i Paper 


Budget 
$ Actual 


Figure 7-1 Creating a Hotspot 
2. Choose Hotspot Actions. 
The Hotspot Action dialog box appears. 


3. Select Open File - Add to Retrace Path in the Action 
Description list box. 


4. Choose Insert. 


The dialog box shown in Figure 7-2 appears. 


9; 
6. 


re 


Exercise 7: Going to Another Screen 


Open File Action 


Filename: 


Directory: e:\ls\tutorial 


Files: irectories: 


screen? Ist 


XJ Search Path 


Figure 7-2 The Open File Action Dialog Box 
Select SCREEN2.LSF from the Files list box. 
Choose OK. 


The dialog box should look like Figure 7-3. 


Hotspot Action 


Open File - Add to Retrace Path. File: SCREEN2.LSF 


Action Description: 


Open File - Add to Retrace Path 


Figure 7-3 The Hotspot Action Dialog Box 


Choose OK. 
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Defining Hotspot Now you'll define the parameters that will be passed to 
Parameters SCREEN2.LSF. You will pass the name of the current text file 
in datafile and the name of the current report title in report. 
Q To define the hotspot parameters: 
1. Choose Hotspot Parameters. 
The dialog box shown in Figure 7-4 appears. 
2. In the Name text box, type: 
report 
or, select report from the drop-down variables list box. 
3. Press TAB to move to the Value text box and type: 
@ (report) 


4. Press SHIFT+TAB to move back to the Name text box, and 


type: 

datafile 

or, select datafile from the drop-down variables list box. 
5. Press TAB to move to the Value text box and type: 

@ (datafile) 


The dialog box should look like Figure 7-4. 
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Hotspot Action Parameters Co 
m e ee E 


Name = Value List: 
datafile = @[datafile 


report = @{report)} 


Figure 7-4 The Hotspot Parameters Dialog Box 


6. Choose OK. 


Going to Another Screen 


O To go to the second screen: 


4 IB 


2. 


Press F4. 


Then click on the hotspot on the text file document 
object. 


You will be prompted to save any changes you have made 
to the screen. 


Choose Yes. 
SCREEN2.LSF opens. You may want to turn on View 


Outline All Objects and View Display Hidden Objects to 
explore the objects on the screen. 
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Tutorial Screen 2 Re 


Eile Edit Special Return! 


Global Industries, Inc. 


1989 1990 1991 


Consolidated Report Total Sales vs Total Expenses 


Figure 7-5 The Second Screen 


This screen displays a chart of the current division’s total sales 
and expenses from 1987 to 1991. 


Choose a chart icon to display the same data with a different 
chart type. 


= 


Exploring the Screen 


0 
1. 


To explore this screen: 
Press F4 to go to the Author level. 
Choose View Outline All Objects. 


Choose View Show Hidden Object. 


Hidden Return! Menu 
Object 


One Large Image 
Object 


Chart Object 


A Document Object Is 
Behind the Chart 


Text Object 


Hotspots 
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Image Object 


Lightship - EALS UTOHIAI SCHEEN? SI 


ool Chart 
slobal Industries, Inc. 


Menu Bar: Return! 


1988 1989 1390 1991 


= Conealidated Report Total Salee vs Total- Expenses ‘I 


Figure 7-6 Showing All the Objects | 


A Draw Object Is in Front of the Charts Chart Objects 


4. Select each object you want to know about and look at its 
attributes. 


The chart graphs two data series. The data is selected from a 
document object behind the visible chart and the large image 
object. The document object source is driven by the variable 
datafile that you passed into this screen. The chart object 
uses text from the document object for the category labels and 
the legend. 


Although the title seems to be part of the chart, it is a text 
object that references the variable report. The chart title 
changes whenever you open the screen with a different report. 


Each chart icon on the bottom of the screen has a hotspot in 
front of it. When you choose a hotspot, it assigns a number 
that represents the chart type that you selected. Then it checks 
to see if the chart type you selected is already displayed. If the 
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chart is displayed, the hotspot does not execute any further 
actions. 


If the chart type is not displayed, the POSITION function 
moves the visible chart to a predetermined position at the 
bottom of the screen, behind a large draw object. It then 
moves the newly selected chart from its position on the lower 
screen to the center of the screen where you see it displayed. 


Note that you can display the size and position of the selected 
object by choosing View Status. For more information on the 
POSITION function, refer to the LightShip Reference Guide. 


The hotspots use the Highlight Group 1 command to group 
them together like option buttons. When you choose a 
hotspot in the group, it becomes highlighted to show that it is 
actively selected and the previously selected hotspot becomes 
unhighlighted. 


Take care not to move any of the charts out of position or the 
POSITION function will not work. If you do move an object, 
you should choose File Open again to redisplay the screen. At 
the "Save Modifications..." prompt, choose No. 


The Return! menu bar command returns you to the previous 
screen. Its action opens the previous screen and clears the 
retrace path. It also passes back parameters for the current 


report name and the report filename so that when the 
previous screen opens, it still displays the current report. 


a a 
Editing the Return Menu Object 


You need to edit the menu object that controls the return to 
the first screen so that it uses the correct filename. 


O To edit the menu object: 


1. Press F4 to go to the Author level. 


Exercise 7: Going to Another Screen 


2. Select the Return! menu object. 
3. Choose Menu Actions. 


Open File - Clear the Path is already selected in the 
Actions list box. 


1. Open File - Clear the Retrace Path, File: MYSCRN1 LSE’ 


Open File - Clear the Retrace Path. File: MYSCRN1.LSF 


File - Add to Retrace Path 


Suen File - Clear the Retrace Path 


Figure 7-7 Editing the Menu Action 
4. Choose Replace. 
The Open File Action dialog box appears. 
5. Make sure the Search Path check box is turned on. 
6. Select the filename of the screen you created. 
7. Choose OK. 


8. Choose OK. 
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Returning to the First Screen 
O To return to the first screen: 
1. Press f4. 
2. Choose Return! 
You will prompted to save modifications to the file. 


3. Choose Yes. 


This concludes the LightShip tutorial. 
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